CLOSECAP

 Function
  Close the capture file previously opened with OPENCAP

 Syntax
  CLOSECAP   No arguments are required

 Remarks
  PCBoard has the ability to capture screen output to a file for later
  reference.  PPL allows that same ability via the OPENCAP and CLOSECAP
  statements.  This could be useful in a program that executes a series of
  commands in non-stop mode.  The process could open a capture file first,
  execute the commands, close the capture file, then allow the user to
  view or download the capture file.  CLOSECAP closes the capture file and
  turns off screen capturing.  Also, the SHOWON and SHOWOFF statements can
  be used to turn on and off showing information to the screen while
  allowing that same information (even if not displayed or transmitted
  via modem) to be captured to a file.  The SHOWSTAT() function can be used
  to check the current status of the SHOWON and SHOWOFF statements.

 Examples
  BOOLEAN ss
  LET ss = SHOWSTAT()
  SHOWOFF
  OPENCAP "CAP"+STRING(PCBNODE()),ocFlag
  IF (ocFlag) THEN
   DIR "U;NS"
   CLOSECAP
   KBDSTUFF "FLAG CAP"+STRING(PCBNODE())+CHR(13)
  ENDIF
  IF (ss) THEN
   SHOWON
  ELSE
   SHOWOFF
  ENDIF